<html><head><title>AddPathCircle</title></head>
<body bgcolor="#EFF1F0" link="#3A3966" vlink="#000000" alink="#000000">
<font face="Verdana, sans-serif" size="2"><p align="center"><b><font size="4">AddPathCircle()</font></b></p>
<p><b>Syntax</b></p><blockquote>
<font color="#3A3966"><b>AddPathCircle</b></font>(x.d, y.d, Radius.d [, StartAngle.d, EndAngle.d [, Flags]])</blockquote>

</blockquote>
<b>Description</b><br><blockquote>

Add a circle (or a partial circle) to the vector drawing path. 
<br>
<br>
By default, this function ends the current figure in the path and adds the circle 
as an unconnected figure to the path (full circles are marked as closed). 
This behavior can be changed with the appropriate flags. 

</blockquote><p><b>Parameters</b></p><blockquote>
<style type="text/css">
table.parameters { border-spacing: 0px; border-style: none; border-collapse: collapse; }
table.parameters td { border-width: 1px; padding: 6px; border-style: solid; border-color: gray; vertical-align: top; font-family:Arial; font-size:10pt; }
</style>
<table width="90%" class="parameters">
<tr><td width="10%"><i>x.d, y.d</i></td>
<td width="90%"> 
Specifies the center point for the circle. 

</td></tr>
<tr><td><i>Radius.d</i></td>
<td> 
Specifies the radius for the circle. 

</td></tr>
<tr><td><i>StartAngle.d, EndAngle.d (optional)</i></td>
<td> 
Specifies the angle for start and end of the circle in degrees. The angle 0 marks 
at the positive X axis. The defaults are 0 and 360 degrees respectively. 

</td></tr>
<tr><td><i>Flags (optional)</i></td>
<td> 
This can be a combination of the following values: 
<pre><font face="Courier New, Courier, mono"size="2">  <font color="#924B72">#PB_Path_Default</font>          : No special behavior (default value)
  <font color="#924B72">#PB_Path_Relative</font>         : The positions are relative to the last cursor position.
  <font color="#924B72">#PB_Path_Connected</font>        : The circle is connected to the existing path with a line and not automatically a closed figure.
  <font color="#924B72">#PB_Path_CounterClockwise</font> : The drawing direction between the start/end angles is counter-clockwise.
</font></pre>

</td></tr>
</table>
</blockquote><p><b>Return value</b></p><blockquote>
None.


</blockquote><p><b>Remarks</b></p><blockquote>

This function is indended for drawing standaline circles or arcs. To draw figures with rounded 
corners, the <a href="addpatharc.html">AddPathArc()</a> function can be used which automatically calculates the proper angles 
and center point to draw rounded corners. 

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2">  <b><font color="#3A3966">If</font></b> <font color="#3A3966">OpenWindow</font>(0, 0, 0, 400, 200, &quot;VectorDrawing&quot;, <font color="#924B72">#PB_Window_SystemMenu</font> | <font color="#924B72">#PB_Window_ScreenCentered</font>)
<font color="#3A3966">    CanvasGadget</font>(0, 0, 0, 400, 200)

    <b><font color="#3A3966">If</font></b> <font color="#3A3966">StartVectorDrawing</font>(<font color="#3A3966">CanvasVectorOutput</font>(0))

      <font color="#3A3966">; partial circle</font>
<font color="#3A3966">      AddPathCircle</font>(100, 100, 75, 0, 235)
      
      <font color="#3A3966">; partial circle with lines to the center</font>
<font color="#3A3966">      MovePathCursor</font>(300, 100)
<font color="#3A3966">      AddPathCircle</font>(300, 100, 75, 0, 235, <font color="#924B72">#PB_Path_Connected</font>)
<font color="#3A3966">      ClosePath</font>()
      
<font color="#3A3966">      VectorSourceColor</font>(<font color="#3A3966">RGBA</font>(255, 0, 0, 255))
<font color="#3A3966">      StrokePath</font>(10)
    
<font color="#3A3966">      StopVectorDrawing</font>()
    <b><font color="#3A3966">EndIf</font></b>
    
    <b><font color="#3A3966">Repeat</font></b>
      Event =<font color="#3A3966"> WaitWindowEvent</font>()
    <b><font color="#3A3966">Until</font></b> Event = <font color="#924B72">#PB_Event_CloseWindow</font>
  <b><font color="#3A3966">EndIf</font></b>
</font></pre>

<p><img src="../HelpPictures/addpathcircle.png"></p>

</blockquote><p><b>See Also</b></p><blockquote>

<a href="movepathcursor.html">MovePathCursor()</a>, <a href="addpathline.html">AddPathLine()</a>, <a href="addpatharc.html">AddPathArc()</a>, 
<a href="addpathbox.html">AddPathBox()</a>, <a href="addpathellipse.html">AddPathEllipse()</a>, <a href="addpathcurve.html">AddPathCurve()</a> 

</Blockquote><p><b>Supported OS </b><Blockquote>All</Blockquote></p><center><- <a href=addpathbox.html>AddPathBox()</a> - <a href="index.html">VectorDrawing Index</a> - <a href="addpathcurve.html">AddPathCurve()</a> -><br><br>

</body></html>